Manager: Internet Config



Carbon supports all relevant Internet Config functionality. Various obsolete functions are not supported. In particular:

- ICGetMappingInterruptSafe, ICGetSeedInterruptSafe, and ICRequiresInterruptSafe are not compatible with preemptive threads. (In the unlikely event that your application relies on these APIs, contact Apple Developer Technical Support.)

- Functions prefixed with "ICC" were orginally supplied to support the Component Manager model. You can instead use variants prefixed by "IC."

- Several functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions.

- Because Internet Config no longer supports multiple configuration files, the ICGetConfigReference and ICSetConfigReference are obsolete. There are no replacement functions for these.

- The private function ICRefreshCaches is obsolete. There is no supported way to modify the Internet Config database without going through the Internet Config API. There is no replacement function.

- Because Internet Config is not component-based under X, use ICGetVersion instead of ICGetComponentInstance.

Supported  ICAddMapEntry

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICAddProfile

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICBegin

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICCAddMapEntry

Use ICAddMapEntry instead.

Not available in Carbon.

Unsupported  ICCAddProfile

Use ICAddProfile instead. Not available in Carbon.

Unsupported  ICCBegin

Use ICBegin instead. Not available in Carbon.

Unsupported  ICCChooseConfig

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Unsupported  ICCChooseNewConfig

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Unsupported  ICCCountMapEntries

Use ICCountMapEntries instead. Not available in Carbon.

Unsupported  ICCCountPref

Use ICCountPref instead. Not available in Carbon.

Unsupported  ICCCountProfiles

Use ICCountProfiles instead. Not available in Carbon.

Unsupported  ICCCreateGURLEvent

Use ICCreateGURLEvent instead. Not available in Carbon.

Unsupported  ICCDefaultFileName

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICCDeleteMapEntry

Use ICDeleteMapEntry instead. Not available in Carbon.

Unsupported  ICCDeletePref

Use ICDeletePref instead. Not available in Carbon.

Unsupported  ICCDeleteProfile

Use ICDeleteProfile instead. Not available in Carbon.

Unsupported  ICCEditPreferences

Use ICEditPreferences instead. Not available in Carbon.

Unsupported  ICCEnd

Use ICEnd instead. Not available in Carbon.

Unsupported  ICCFindConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICCFindPrefHandle

Use ICFindPrefHandle instead. Not available in Carbon.

Unsupported  ICCFindUserConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICCGeneralFindConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICCGetComponentInstance

Because Internet Config is not component-based under X, use ICGetVersion instead of ICCGetComponentInstance. Not available in Carbon.

Unsupported  ICCGetConfigName

Use ICGetConfigName instead. Not available in Carbon.

Unsupported  ICCGetConfigReference

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Unsupported  ICCGetCurrentProfile

Use ICGetCurrentProfile instead. Not available in Carbon.

Unsupported  ICCGetDefaultPref

Use ICGetDefaultPref instead. Not available in Carbon.

Unsupported  ICCGetIndMapEntry

Use ICGetIndMapEntry instead. Not available in Carbon.

Unsupported  ICCGetIndPref

Use ICGetIndPref instead. Not available in Carbon.

Unsupported  ICCGetIndProfile

Use ICGetIndProfile instead. Not available in Carbon.

Unsupported  ICCGetMapEntry

Use ICGetMapEntry instead. Not available in Carbon.

Unsupported  ICCGetMappingInterruptSafe

ICCGetMappingInterruptSafe is not compatible with preemptive threads. If your application relies on this API, contact Apple Developer Technical Support. Not available in Carbon.

Unsupported  ICCGetPerm

Use ICGetPerm instead. Not available in Carbon.

Unsupported  ICCGetPref

Use ICGetPref instead. Not available in Carbon.

Unsupported  ICCGetPrefHandle

Use ICGetPrefHandle instead. Not available in Carbon.

Unsupported  ICCGetProfileName

Use ICGetProfileName instead. Not available in Carbon.

Unsupported  ICCGetSeed

Use ICGetSeed instead. Not available in Carbon.

Unsupported  ICCGetSeedInterruptSafe

ICCGetSeedInterruptSafe is not compatible with preemptive threads. If your application relies on this API, contact Apple Developer Technical Support. Not available in Carbon.

Unsupported  ICCGetVersion

Use ICGetVersion instead. Not available in Carbon.

Unsupported  ICChooseConfig

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Unsupported  ICChooseNewConfig

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Unsupported  ICCLaunchURL

Use ICLaunchURL instead. Not available in Carbon.

Unsupported  ICCMapEntriesFilename

Use ICMapEntriesFilename instead. Not available in Carbon.

Unsupported  ICCMapEntriesTypeCreator

Use ICMapEntriesTypeCreator instead. Not available in Carbon.

Unsupported  ICCMapFilename

Use ICMapFilename instead. Not available in Carbon.

Unsupported  ICCMapTypeCreator

Use ICMapTypeCreator instead. Not available in Carbon.

Supported  ICCountMapEntries

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICCountPref

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICCountProfiles

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICCParseURL

Use ICParseURL instead. Not available in Carbon.

Supported  ICCreateGURLEvent

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICCRefreshCaches

This function is obsolete, because there is no supported way to modify the Internet Config database without going through the Internet Config API. There is no replacement function. Not available in Carbon.

Unsupported  ICCRequiresInterruptSafe

This function is not compatible with preemptive threads. There is no replacement. Not available in Carbon.

Unsupported  ICCSendGURLEvent

Use ICSendGURLEvent instead. Not available in Carbon.

Unsupported  ICCSetConfigReference

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Unsupported  ICCSetCurrentProfile

Use ICSetCurrentProfile instead. Not available in Carbon.

Unsupported  ICCSetMapEntry

Use ICSetMapEntry instead. Not available in Carbon.

Unsupported  ICCSetPref

Use ICSetPref instead. Not available in Carbon.

Unsupported  ICCSetPrefHandle

Use ICSetPrefHandle instead. Not available in Carbon.

Unsupported  ICCSetProfileName

Use ICSetProfileName instead. Not available in Carbon.

Unsupported  ICCSpecifyConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICCStart

Use ICStart instead. Not available in Carbon.

Unsupported  ICCStop

Use ICStop instead. Not available in Carbon.

Unsupported  ICDefaultFileName

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Supported  ICDeleteMapEntry

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICDeletePref

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICDeleteProfile

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICEditPreferences

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICEnd

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICFindConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Supported  ICFindPrefHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICFindUserConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICGeneralFindConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Unsupported  ICGetComponentInstance

Because Internet Config is not component-based under X, use ICGetVersion instead of ICGetComponentInstance. Not available in Carbon.

Supported  ICGetConfigName

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICGetConfigReference

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Supported  ICGetCurrentProfile

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetDefaultPref

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetIndMapEntry

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetIndPref

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetIndProfile

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetMapEntry

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICGetMappingInterruptSafe

Because ICGetMappingInterruptSafe is not compatible with preemptive threads, it has been removed from Carbon. Not available in Carbon.

Supported  ICGetPerm

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetPref

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetPrefHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetProfileName

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICGetSeed

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICGetSeedInterruptSafe

Because ICGetSeedInterruptSafe is not compatible with preemptive threads, it has been removed from Carbon. Not available in Carbon.

Supported  ICGetVersion

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICLaunchURL

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICMapEntriesFilename

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICMapEntriesTypeCreator

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICMapFilename

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICMapTypeCreator

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICParseURL

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICRefreshCaches

This function ICRefreshCaches is obsolete. There is no supported way to modify the Internet Config database without going through the Internet Config API. There is no replacement function.

Not available in Carbon.

Unsupported  ICRequiresInterruptSafe

Because ICRequiresInterruptSafe is not compatible with preemptive threads, it has been removed from Carbon. Not available in Carbon.

Supported  ICSendGURLEvent

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICSetConfigReference

Because Internet Config no longer supports multiple configuration files, this function is obsolete, and there is no replacement function. Not available in Carbon.

Supported  ICSetCurrentProfile

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICSetMapEntry

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICSetPref

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICSetPrefHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICSetProfileName

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  ICSpecifyConfigFile

Functions related to locating files in the IC database are obsolete. You can simply remove these calls from your code -- there are no replacement functions. Not available in Carbon.

Supported  ICStart

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ICStop

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 8/1/2000. Copyright © 1999, 2000 Apple Computer, Inc. All rights reserved.